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1. FM-Synthesizer Descriptions 

The followings are the detail descriptions of FM- 
synthesizer block that are shown in YMF715x 
(OPL3-SA3) specification. The FM-synthesizer is 
compatible with YMF262(OPL3)/YMF289B(OPL3- 
L) used for the Sound Blaster/Adlib game music 
synthesizer which is de facto standard in sound card 


market. 


1-1. Overview of FM-synthesizer 
FM stands for 


synthesis exploits the fact that modulating one 


“Frequency Modulation”. FM 


waveform with another waveform will produce a 
waveform with many more harmonics than were 
present in the modulator or carrier (the modulated 
wave form). The frequency ratio of modulator to 
carrier will determine which harmonics will result. 
Using integer and non-integer ratios allows the user to 
create rich harmonic and inharmonic sounds from two 
sine waves. 

In Fig.1-1, the sine wave oscillators are called 
operators. The first box is called a modulator and 
next box is called a carrier. The arrangement of 
operators is called an algorithm. YMF715x (OPL3- 
SA3) FM-synthesizer can use two operators in two 
different algorithms and four operators in four 


different algorithms. 


Operator 1 


Operator 2 


Modulator Carrier 
m c 


10) 10) 


Fig. 1-1 Basic Configuration of a simple FM System 


The configuration shown in Fig.1-1 can be expressed 


in an equation as follows : 


FM(t) = A sin (@,t + B sin ®t) 
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In this equation, A and B represent the amplitude of 
operators 2 and 1 respectively. The angle frequency 
of operators 2 and 1 are respectively represented by 
Me and Wp. 

YMF715x (OPL3-SA3) FM-synthesizer also provides 
an operator that features feedback which allows that 


operator to modulate itself as shown in fig. 1-2. 


Fig. 1-2 Feedback FM System 


This oerator can be expressed in the equation below: 
FM(t) = A sin {@t + BFM(t)} 


where B represents feedback ratio. Feedback FM is 
an economic way of producing a spectra rich in 
harmonics. One feedback operator can produce a 
sawtooth-like spectra (which is useful when trying to 


make string sounds). 


1-2. Register Interface 

Listed below are the YMF715x (OPL3-SA3) FM- 
synthesizer registers for AdLib compatibility. Table 
1-1 is the all register mapping of the FM-synthesizer. 


Adlib base+0 | Status Register port 
Adlib base+0 Address Register port (array 0) 


Adlib base+1 Data Register port 
Adlib base+2 Address Register port (array 1) 
Adlib base+3 Data Register port 
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Table 1-1. FM-synthesizer Status/Data Register Mapping 


i) 


re 
mai 


Status Register (RO): 


Data Register Array 0 (R/W): 
index [ov [| 6 [ os | o | os | oe | 1 | bo | 
pom TR 


TIMER 1 
TIMER 2 


KSL 


0-em[ [wow [tock 
[eon [ome | oe [wey |e [so [row [To [ mi 


co-cen] * | * | cur | cu | re cnr 
FS Ac a A ee a | 


Data Register Array 1 (R/W) 
| index | 7 | oe | os | o4 | os | o2 | or | om | 
Pon [| - | - | __ Connections 
| 05h 
ene 


fe Oe eal Slt] ANEW] NEW" 
20 - 36h ES 


F-NUM (L) 
oon [Nok 
[= DC a 
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When the YMF715x (OPL3-SA3) FM-synthesizer is 
used with /EXTEN pin when SEL=3, 4, 7 is driven 
“L” for a wavetable upgrade as a chip-set with the 
YMF721 (OPL4-ML2), the additional I/O ports listed 
below can also be accessed. In the case of SB (Sound 
Blaster) mode, AdLib base + 2, 3 port are write-only 


registers. 


Adlib base+4 | R | Status Register port for Wavetable 
Adlib base+4 Address Register port for Wavetable 
Adlib base+5 Data Register port for Wavetable 


Adlib base+6 Command write/response port 
Adlib base+7 Control write/status port 


1-3. Status Register 


The follwing are FM-synthesizer status register. 


Status Register (RO): 
| port | 07 | pe | os | v4 | os | v2 | 1 | oo | 


| +on | ira | eri | Fre | - | - |pusy| - |Busy| 


YMF715x (OPL3-SA3) FM-synthesizer block has 
two programmable timers. Each timer provides the 
flag according to value of timer | or timer 2. The host 
can read these flags as status information or interrupt 


signal. 


IRQ 
Interrupt ReQuest flag : This bit can read as 
“1” when either of FT1 or FT2 bit is set to “1”. 
This bit is reset when index 04h (array 0), RST 


bit is set to “1”. 


FT1 
Flag Timer | : This bit can be read “1” when 
the time set at timer | has elapsed. This bit is 
cleared when index 04h (array 0), RST bit is 
set to “1”. 

FT2 


Flag Timer 2 : This bit can be read “1” when 
the time set at timer 2 has elapsed. This bit is 
cleared when index 04h (array 0), RST bit is 


set to “1”. 
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BUSY 

BUSY flag : This bit is available when index 
O5h (array 1), NEW3 bit is set to “1”. 
YMF715x (OPL3-SA3) FM-synthesizer block 
requires approximately 960nsec (*1) wait time 
until data presented at Data Bus will be written 
to internal register. This bit indicates wait time, 
in which access to register is prohibited. When 
this bit can be read as “1”, don’t access the 
register. 

*1) About 1.6usec in case of YMF715/715B. 


default : 0OOh 


1-4. Data Registers 

all FM-synthesizer data 
registers of YMF715x (OPL3-SA3). These data 
registers are compatible with YMF289B (OPL3-L) 
and readable. Note that data regsigers of YMF262 
(OPL3) are not readable. All registers are cleared 
except index CO-C8h, CHR and CHL bits is set to “1” 


after power-on-reset. 


This section describes 


LSI TEST : (array0,1) 
oo- |_o7 | oe | os | os | os | v2 | ot | co | 


Oth LSI TEST 


LSI TEST 
These two registers are used for LSI testing . 
All bits should be left “O”. 


default : 0OOh 


TIMER1/2 (R/W) : (array) 
comes OE oe] doe ee a 
02h 


TIMER 1 


index | b7_| o6 | 05 | 04 | o3_| v2 | o1 | oo | 


03h TIMER 2 
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Timer operation is described below. When index 04h 
(array0), ST1/ST2 bit is set to “1”, the value of timer 
1/2 register is loaded into counter 1/2 and counter 1/2 
starts to count down. When counter 1/2 occurs 
underflow, the interrupt signal, IRQn assigned by 
software is active and status register, FT 1/FT2 can be 
read as “1”. The counter 1/2 reloads the value of 


timer 1/2 register and continues to count down. 


TIMERI 
Timer 1 value set : Timer 1 has 80.8 usec 


resolution. The elapsed time between 
underflow is expressed as follows. 
tl [msec]=(256-N1) X 0.0808 


(NI : register value) 


TIMER2 
Timer 2 value set : Timer 2 has 323.1 usec 
resolution. The elapsed time between 
underflow is expressed as follows. 
t2 [msec ]=(256-N2) X 0.3231 


(N2 : register value) 


default : 00h (index 02, 03h) 


TIMER Control (R/W) : (array0) 
index |_o7_| be _[ os | p4 | o3 | o2 | m1 [ bdo | 


oan | rst{[ mri | mra] - | - | - | ste{ sm | 


RST 
Timer Reset : When this bit is set to “1”, status 
register, IRQ, FT1 and FT2 bits are reset. after 
these flag bits are reset, this RST bit is 


automatically set to “0”. 


MT1 
Timer | Disable : When this bit is set to “1”, 
status register flag, FT1 is “0” regardless of 


timer | operation. 


MT2 
Timer 2 Disable : When this bit is set to “1”, 
status register flag, FT2 is “0” regardless of 


timer 2 operation. 
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ST2 
Timer 2 Start : When this bit is set to “1”, 
timer 2 counter loads the value of timer 2 
register (index 03h) and starts to count down. 
When it is set to “0”, timer 2 counter stops to 
count. 

ST1 


Timer 1 Start : When this bit is set to “1”, 
timer 1 counter loads the value of timer 1 
register (index 02h) and starts to count down. 
When it is set to “0”, timer 1 counter stops to 


count. 


default : OOh 


4-Operator Mode Set (R/W) : (array1) 
index |_b7_| pe | ps5 | v4 | p3 | v2 | pt | bo | 
o4n [ - | - | CONNECTION SEL 


CONNECTION SEL 
4-Operator mode set : When these bits are set 
to “1”, the corresponding slot can be used as 
the 4-operator mode. The relationship between 
these bits and 4-operator mode channel 


number is shown below. 


| _index__| ps | _p4_| 03 | o2 | 01 | bo | 


4-operator 
mode 5 4 3 2 1 
Channel No. 


default : 0OOh 


Expansion Register (R/W) : (array1) 
index |_07 | dé | os [ o4 [| os | v2 | ot | co | 


opn | - | - | - | - | - [News] + [New| 


NEW3 
OPL3-L expansion register : When this bit and 
NEW bit are set to “1”, extended bit, status 
register, BUSY bit is available. 


Page 5 


July 11, 1997 


ip 


YAMAHA 


| 


Register Description Document 


YME715x(OPL3-SA3 


NEW 
When this bit is set to “1”, registers expanded 
to YMF262(OPL3) from YMF3812(OPLI), 
i.e. register array | is available. Notice that 
should be set NEW bit to “0”, when the 
application software operates in OPLII mode, 
i.e. only register array 0 is available, because 
the sound data could fail to be available in this 


mode. 


Notice) The bit marked * indicate that this can be 


read/written but is not effective. 


default : 0OOh 


Keyboard Split Selection (R/W) : (array0) 
index |_D7_| pe | ps5 | p4 | 03 | 2 | 01 | bo | 


Le en Be ee ee ee 


NTS 
Keyboard Split : Rate scaling is performed by 
splitting 8 octaves into 16 parts. This bit 
determines the keyboard split separation 

points. 

“OQ” : determined by the second bit of the 
F_number 

“1” : determined by the MSB of the F_number 


This is shown in the table below. 


NTS=“0” 
lemsat - | - [ - [ - [ - [T- 7-7. | 


[rend fo[sfo[sfo[sfo]s]o]s]ofs]ofs of | 
| «sw Joli }2{s}a{s]el{7] as }roftt]r2[13] 14] 15] 


NTS=‘“ 1 ” 

locke [tc [Ste esl) 8s [a 2 ef 6s) 

fr wse}ol1fols}ol{sfol{s}o]s}of1]of1]o]1 | 
ee ee ee ee ee ee 


| «sn Jolt f2]s}a{sje]7{a]}roli}r2]i3] 14] 15| 


Note) Block is “Octave”, F_MSB is “F_number 
MSB”, F_2nd is “F_number 2nd” and KSN is “Key 


scale No”. 


default : 0OOh 
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Slot Register 1 (R/W) : (array0,1) 
| 2 pa Oe Oe 
35h 


AM 
Tremolo effect : When this bit is set to “1”, a 
tremolo effect can be applied to the 
corresponding slot. The tremolo frequency is 
3.7Hz. Its depth is determined by index BDh, 


DAM bit. 


VIB 
Vibrato effect : When this bit is set to “1”, a 
vibrato effect can be applied to the 
corresponding slot. The vibrator modulation 
frequency is 6.0Hz. Its depth is determined by 


index BDh, DVB bit. 


EGT 
Non-percussive sound : This bit determines 
whether percussive sound or non percussive 
sound. The envelope wave form of each mode 


is shown below. 


a) Percussive sound b) Non-percussive sound 


Key on 


Key on 


KSR 

Rate Key Scale : Setting this bit to “1” 
performs the rate key scaling. “Rate key scale” 
simulates the phenomena that rising time 
(falling time) of sound becomes faster as the 


note of acoustic instrument is higher. 


Note) Relation between set value and actual time 

The actual ATTACK/DECAY/RELEASE time is the 
sum of Attack Rate : AR/Decay Rate : DR/Release 
Rate : RR and the key scaling offset , R,; shown 


below. The key scaling offset is specified as follows. 
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| «sn [ol rf2{s}a{sle{7{s]ofrolr}r2] 13] 14]15] 


[kse-o]ofofofo]+[s]+]1]e2[2le2fa[s[s]s]s| 
ksret}oli}2[sa}a{s]el{7] a] s frofi|r2[13] 14] 15] 


To find the actual rate time, calculate the RATE value 
and then refer to the “Rate Value-Actual Time Table”. 
The RATE is specified as follows. 

RATE=(RATE Value)X4+Ro- 
when RATE Value is “0”, RATE=“0”. When RATE 
exceeds 63, RATE=63 is assumed. 


MULT 3-0 

Frequency Multiplier : These bits specify the 
multiplier for the frequency determined by 
index BO-B8h, BLOCK bits and index AO- 
B8h, F_number bits. These bits determines the 


frequency ratio between operators. 


MULT | 0 2/314] 5]6] 7] 8] 9 {10)11] 12,13] 1415 


: 
[mutipior]vel 1] 213] 4] sle]7] es frolro}r2}i2] 15]15) 


default : 0OOh 


Slot Register 2 (R/W) : (array0,1) 
2 ee 
55h TL5-0 


KSL 

Level Key Scale : The volume of acoustic 
instruments decreases as the note of sound is 
higher. Level key scale simulates this 
phenomena. This bit gives the attenuation to 
every octave as follows. The relation between 


set value and the attenuation is shown below. 


cae ee ee 
| Damping |__o | saB/oct [1.5aB/oct] 6aB/oct | 


Note) The actual level attenuation is determined by 
the value of the higher 4 bits of the F_number. When 
these bits are “1”, the attenuation is specified as 


follows. 
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re 
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Fer ee 
FNUM 
a 


re ee ee 
a 


[al ol a seo ona 
| 5 | of of 4.125] 4.125] 7.125] 10.125] 13.125] 16.125| 
| 6 | of of 1.875] 4.875] 7.875] 10.875] 13.875] 16.675| 


| 7 | of _o| 2.625] 5.625] 8.625] 11.625] 14.625] 17.625, 
| 8 | of of 3.000] 6.000] 9.000] 12.000] 15.000] 18.000 
| 9 | of 0.750] 3.750] 6.750] 9.750] 12.750] 15.750] 18.750 
| 10 | of 1.125] 4.125| 7.125] 10.125] 13.125] 16.125] 19.125] 
| 11 | of 1.500] 4.500] 7.500] 10.500] 13.500] 16.00] 19.500 
| 12 | of 1.875] 4.875| 7.875] 10.875] 13.875] 16.875| 19.875| 
| 13 | of 2.250] 5.250] 8.250] 11.250] 14.250] 17.250] 20.250 
| 14 | of 2.625] 5.625] 8.625] 11.625] 14.625] 17.625] 20.625] 
| 15 | 0] 3.000] 6.000] 9.000] 12.000] 15.000] 18.000] 21.000 


KSL=“2” : 
KSL=“3” : 


1/2 of the above 
double of the above 


TL 5-0 
Total Level 


damping. This can control the volume and 


: These bits set the envelope 


modulation rate. Total level is given by the 

following equation. 

TL[dB]=(-24XL5) + (-12XL4) + (-6XL3) + 
(-3XL2) + (-1.5XL1) + (-0.75XLO) 


default : 0OOh 


Slot Register 3 (R/W) : (array0,1) 
| pete Be ee os Te Te Lo 
75h AR 3-0 


AR3-0 
Attack Rate : These bits specify the attack rate. 
The set value is 0 to 15. The larger the set 
value, the shorter the rise time of the sound. 
Please refer to index 20-35h, Rate Key Scale 
and “Rate-Actual Time Table” 


regards the actual rate time. 


section as 
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DR3-0 
Decay Rate : These bits specify the decay rate. 
The set value is 0 to 15. The larger the set 
value, the shorter the time. Please refer to 
index 20-35h, Rate Key Scale and “Rate- 
Actual Time Table” section as regards the 


actual rate time. 
default : 0OOh 


Notice) For the envelope, see the “Envelope Rate” 


section. 


Slot Register 4 (R/W) : (array0,1) 
2 poh Lo os Loe oe 
95h SL.3-0 


SL3-0 

Sustain Level : These bit specify sustain level. 
When index 20-35h, EGT bit is set to “1” 
(non-percussive), the level output from slot is 
held after the attenuation reaches the level set 
in these bits. When EGT bit is set to “0” 
(percussive), the falling rate is switched to 
release rate from decay rate after the 
attenuation reaches the level set in these bits. 
The sustain level is specified by attenuation as 
follows. 

L[dB]=(-24XSL3) + (-12XSL2) + (-6XSL1) 

+ (-3XSLO) 
When all the bits are “1”, SL becomes -93dB. 


RR3-0 

Release Rate : These bits specify the release 
rate. The set value is 0 to 15. The larger the set 
value, the shorter the time. Please refer to 
index 20-35h, Rate Key Scale and “Rate- 
Actual Time Table” section as regards the 


actual rate time. 
default : 00h 
Notice) For the envelope, see the “Envelope Rate” 


section. 
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Slot Register 5, 6 (R/W) : (array0,1) 
ao- _o7 [| v6 | os | 4 | v3 | v2 | 01 | do | 


A8h F_NUMBER 7-0 


Bo- | _b7_| pé_| ps | p4 | 03 | pe | 01 | vo | 


peh | - | - [kon] BLock20 | FNUM96 | 


F_NUMBER 9-0 
Frequency Information : These bits determine 


the frequency information for one octave. 


KON 
Key on: This bit controls synthesize on/off. 
“1”: key on 
“0” : key off 


BLOCK 
Octave : This bit specifies the octave 
information. F_number is determined by tone 
pitch (frequency) and BLOCK as follows. 


(Tone Pitch) X 2° 


F Number = SoS pASbDL DD 2 la 
7 QBLOCK! YX 49 _518kHz 


Example of F_Number setting (BLOCK value 
is set to “4”). F_Number can also be set to 


other than the below. 


Pp [oa 7tHal| 389 | 


[8 [assay esa 


default : OOh(A0-A8h, BO-B8h) 
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Rhythm Instrument Sel. (R/W) : (arrayO) 
index |_b7_| pe | os | v4 | os | v2 | 01 | do | 


Slot Register 7 (R/W) : (array0,1) 
co- ov [pe | ps | 4 | v3 | v2 | 01 | do | 


BDh | pam | bvB | RHY| 8D | sD _| Tom] Tc | HH | 


DAM 

Tremolo depth : This bit determines the 
tremolo depth. 
DAM="1” : 4.8dB 


DAM="0” : 1.0dB 


DVB 
Vibrato depth : This bit determines the vibrato 
depth. 
DVB="1” : 14cent 
DVB=“0” : 7cent 


One cent is a semi-tone divided by 100. 


RHY 
RHYTHM Enable : When this bit is set to “1”, 
slots 13 to 18 are enabled to the rhythm mode. 


BD, SD, TOM, TC, HH 

These bits controls synthesizing of each 
rhythm. If RHY bit is set to “1” (rhythm 
mode), the sound of rhythm instrument is 
synthesized when the bit corresponding to the 
desired instrument is set to “1”. The slot 
number used by each rhythm instrument is 
shown below. Set the rate, etc. to match the 
special features of each musical instrument. 
The parameters (F_NUMBER, EGT, MULT, 
TL, AR, DR, SL, RR, and WS) are available. 
Notice that set KEY ON of slots 13 to 18 to 
“0”. 


Rhythm instrument | Slot No. 
Bass drum (BD 13, 16 
Snare drum (SD) 


Tom-tom (TOM) 
Top cymbal (TC) 
Hi-hat cymbal (HH) 


default : 0OOh 
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CHR, CHL 
Output Right/Left Channel Selection : These 
bits control which channel sound data is output 
from. When CHR/CHL bit is set to “1”, sound 
data is output from R/L channel. In 4-operator 
mode, notice that operators 1 and 2 are 
controlled by index CO-C2h and operator 3 
and 4 are controlled by C3-C5h. This suggests 
that the same value setting for CHR/CHL bits 
of index COh should be set for CHR/CHL bits 
of index C3h (index C4h for index Clh and 
index C5h for index C2h) when you use all of 


the four operators. 


FB 2-0 
Feedback 
applied to slot 1 of each channel. When 


Feedback modulation can be 


feedback modulation is used, string instrument 
sounds can be produced. The feedback 
modulation rate is selected by setting these bits. 
The relation between these bits and 


modulation rate is shown below. 


je. | 0 12g Ao) 6 [| 


[Rate] o [wie] we | w4 | we | nm | an | an | 


CNT 
Algorithm Select : This bit selects the 
algorithm. An “algorithm” is a combination of 
operators. 
(a) 2-operator mode 
When CNT bit is set to “0”, algorithm 1 is 
selected. When this bit is set to “1”, algorithm 
2 is selected. Algorithm can be selected by 
every channel, i.e. index CO-C8h. 
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Alogorithm 1 


Alogorithm 2 


(b) 4-operator mode 

4 algorithm types are selectable by setting two 
CNT bits. The two CNT bits needed in 
algorithm selection at each channel are 


summarized in the table below. 


offset] 4-ope mode Set CNT bit register 
array [Channel No. 


The algorithm is specified by CNT, and 
CNT,,3 as follows. 


(i) Alogorithm 1 CNTn»="0” CNTn+3="0” 


Operator 4 
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(iii) Alogorithm 3 CNTp=“1” CNTn+3="0” 


Operator 4 


Notice) The bits marked * indicate that these can be 
read/written but are not effective. 

In OPLIT mode, i.e. array 1, index 05h, NEW=“0”, 
output of FM-synthesizer becomes monaural mode 
and setting of CHR/CHL bits are ignored. In this case, 
R and L channel are always enabled and output data 


are the same. 


default : 30h 


Slot Register 8 (R/W) : (array0,1) 
Eo- |_p7 | pe | ps5 | o4 | os | o2 | ot [ bo | 


ey Ee ae A 


WS 2-0 
Waveform The waveform used in FM 
operation can be set by every slot unit. The 
relation between these bits and _ selectable 
waveform is shown below. In OPLII mode, i.e. 
array 1, index 05h, NEW=“0”, only WS 2-0= 


“Q”-”3” can be selected. 
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default : 0OOh 


1-5. Envelope Rate 

In case of non-percussive sound envelope, the 
envelope has a dynamic range of 96 dB (resolution : 
0.1875 dB). After index BO-B8h, KON bit is set to 
“1”, the level changes exponentially to 0 dB in attack 
time. When the level reaches 0 dB, envelope is switch 
to falling from rising and the level is attenuated 
linearly to sustain level in decay time. The level is 
held at sustain level until KON bit will be set to “O”. 
When KON bit is set to “0”, the level is attenuated to 
-96 dB in release time. 

In case of percussive sound envelope, after KON bit 
is set to “1”, the level changes exponentially to 0 dB 
in attack time. When the level reaches 0 dB, envelope 
is switch to falling from rising and the level is 


attenuated linearly to sustain level in decay time. 
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When the level reaches sustain level, the level is 
attenuated linearly to -96dB in release time regardless 
of value of KON bit. 


(a) Non-percussive sound envelope 


0dB 


SL 


-96dB 
<—_> 
AR DR RR uae 


Key on 


(b) Percussive sound envelope 


0dB 


The following are Actual Time Tables of attack and 


decay/release rate. 


(a) Attack Rate 


(Units : msec) 
[|_Rate [Time (0-100%) | Time (10-90%) 
ee 
CC 
a 
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(b) Decay/Release Rate 


(Units : msec) 
a 


ps 1964032 [410624 
[9 | st08 16 [3287.08 
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1-6. Register Setting Manner 

YMF715x (OPL3-SA3) FM-synthesizer block has 36 
sine-wave generators. The FM-synthesizer modulates 
frequency using these sine-wave. The sine-wave 
generators is called an “operator” or “slot”. One 
sound generated by combining two or four operators 
is called an “channel”. These are two kind of register: 
one is controlled by every slot unit, another is 


controlled by every channel unit. 


(a) Register setting in slot units 

Index 20-35h, 40-55h, 60-75h, 80-95h and EO-F5h 
registers are controlled by every slot unit. Registers 
address x6h, x7h, xEh, and xFh does not exit. The 


following is example of register address. 


Register Index 


20h_| 2th | 22h | 23h | 24h | 25h - - 


| 2en_| 29h | 2an | 26m | ach | adn {| - | - | 


30h_ | 3th | 32h | 33h | 34h | 35h 


(b) Slot number 

The 36slots are numbered 1 to 36, which are called 
“Slot Number’. The correspondence between Slot 
Number and register address is determined as 


follows. 


a 
[2 [29h aon [can aon | Eon | 
[9s _[2an_[ aah [ean | aah | EA | 
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ip 
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(c) Slot Number and Channel in 2 -operator Mode 

In the 2-operator mode, one FM sound (one channel) 
is generated using 2 slots. Therefore, 18 channels are 
generated in 2-operator mode. Channels are 
numbered same as slot number. These number are 
called “Channel Number’. In two-operator mode, two 


algorithm are available as follows. 


Alogorithm 1 


Modulator Carrier 


Alogorithm 2 


Operator 2 


The correspondence between channel number and 


slot number is shown as follows. 
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offset Slot Number Channel 
array | Operator 1 | Operator 2 Number 
4 1 


o:P 


(e) Slot Number and Channel in 4-operator Mode 

In 4-operator mode, one FM sound (one channel) is 
generated using 4 slots. 6 channels are generated 
using 24 slots in 4-operator mode. In 4-operator mode, 


4 algorithm are available as follows. 


(i) Alogorithm 1 


Operator 4 


In case of algorithm 2, any slot of 2 slots can 
correspond to operator | (operator 2). However, in 
case of algorithm | the timbre depend on which slot is 
the modulator (which slot is carrier). Therefore, be 


careful about slot number. 


(d) Register setting in channel units 


- 2-operator mode - 
Index AO-A8h, BO-B8h and CO-C8h registers are 


controlled every channel unit. The correspondence 


between channel number and register address is 


determined as follows. 


Operator 4 


Operator 4 
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re 
mai 


In 4-operator mode, the correspondence between slot 
number and each operator (operator 1, 2, 3 or 4) is 


determined as follows. 


offset Slot Number Channel 
array Number 
1 4 ve 10 


(f) Register setting in channel units 

- 4-operator mode - 

Index AOQ-A2h, BO-B2h and CO0-C2h registers are 
controlled by every channel unit. However, index C3- 
C5h, CNT bits are used as algorithm parameter (refer 
to description of CNT bit). The correspondence 
between channel number and register address is 


determined as follows. 


| - | __Register Address (Array 1)__| 
-—4__|__Agn__|_Bon_}_coh__| 


(g) Rhythm slot number 

The FM-synthesizer block can generate 5 rhythm 
instruments (bass drum, snare drum, tom-tom, top 
cymbal and hi-hat cymbal) using 6 slots. Rhythm slot 
number are determined to 13-18. Please refer to Data 


Register section. 


(h) Summary 

How all 36 slots are used is summarized below. 

(i) Slot number 1-12 are used in 2-operator mode or 
4-operator mode. 

(ii) Slot number 13-18 are used in 2-operator mode or 
rhythm mode. 

(iii) Slot number 19-30 are used in 2-operator mode 
or 4-operator mode. 

(iv) Slot number 31-36 are used in only 2-operator 


mode. 
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2. Sound Blaster Pro Register 
Descriptions 


The following are the detail descriptions of Sound 
Blaster Pro block that are shown in YMF715x 
(OPL3-SA3) specification. The Sound Blaster Pro 
block is compatible with the standarad game on DOS 
application in regarad to audio data playback mainly 


and de facto standarad in sound card market. 


2-1. Register Interface 
The following are the Sound Blaster Pro block 
registers of YMF715x (OPL3-SA3) which is de facto 


standard on game applications. 


| SB base+0 | R_|FMStatusRegisterport 


| SBbase+8 | R_|FMStatusRegisterport | 
| SBbasetA | R_|DSPRead DataRegister | 


SB base+C R_ | DSP Write-buffer Status Register 


SB base+E | R | DSP Read-buffer status port 


2-2. Register Descriptions 
This section describes all the Sound Blaster pro 


compatible registers. 


FM-synthesizer Status Register (R): 
| port | _p7 | de | os | 04 | 03 [ v2 | 0 | bo | 


FM-synthesizer Address Register(array0) (W): 
| port | 07 | de | os | v4 | os | v2 | ot | oo | 


| port | 07 | oe | os | v4 | os | v2 | 1 | oo | 
FM-synthesizer Address Register(array1) (W): 


| por | o7 | 06 | 05 | o4 | os | o2 | o1 | oo | 


| pot_|_p7 | p6 | os | p4 | ps | v2 | or | do | 


Data Register (array 1) 


FM-synthesizer Status Register (R): 
| port | _o7 | pe | os | v4 | 03 [ v2 | 0 | bo | 


FM-synthesizer Address Register(array0) (W): 
| port | 07 | pe | os | v4 | os | v2 | 1 | oo | 


Address Register (array 0) 


FM-synthesizer Data Register(array0) (R/W): 
| port | 07 | de | os | v4 | os | v2 | 1 | oo | 


Data Register (array 0) 


These register are mapped to the appropriate FM- 
synthesizer. Please refer to the “FM-synthesizer 


descriptions”. 


Mixer Address Register (W): 
| pot | 07 | pe | os | o4 | os | v2 | 1 | co | 


Mixer Address 7-0 
This register is used to specify the mixer 
address. This register should be written before 


any data is accessed from the mixer registers. 


Mixer Data Register (R/W): 
| pot | 07 | pe | os | o4 | os | v2 | 1 | co | 


Mixer Data 7-0 
This register is read/written and provides the 
access to the mixer register depending on the 
index address specified in the mixer address 


register, port+4h. 


DSP Reset Register (W): 
| port | 07 | oe | os | v4 | os | v2 | 1 | oo | 


DSP RESET 
When bit [0] of this register is set to “1” and 
set to “O” after waiting 3.3 usec, the Sound 


Blaster Pro block will be reset. 


DSP Read Data Register (R): 
| port |_o7 | pe | os | v4 | 03 [ v2 | 0 | bo | 
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DSP Read Data 7-0 
This register is for reading the Data/Command 


response. Before reading this port, make sure 
that the Read-buffer status port (port+ Eh) bit 
[7] is 1. 


DSP Write Command Data Register (W): 


| pot_|_p7 | p6 | os | p4 [| os | v2 | or | do | 


COMMAND Data 7-0 


COMMAND Data 7-0 
This 


command/data register for writing. 


register is used as the write 


i) 


re 
mai 


DSP Write-buffer Status Register (R): 


| pot_|_p7 | p6 | os | p4 [| os | o2 | 1 | do | 


Write-buffer Status 


Write-buffer status 
This register is used as the write-buffer status 


for reading. Before writing this register, read 


this port and make sure that bit [7] is “0”. 


2-3. Mixer Register Descriptions 

This section describes the mixer registers in the 
Sound Blaster Pro compatible block. The table below 
is the register mapping of the Sound Blaster Pro 


mixer. 


Table 2-1 Sound Blaster Pro Mixer Register Mapping 


Reset Mixer 


V E ; 
Input Low Pass 
OCh P Input Source 
Filter Filter 
Output Stereo 
Filter 


| ‘Master Vol.Lch Vol. 


ar rv tay 
lee 


D Vo 


| ‘Master Vol.R 1 
eS DT Vol. 
D Vol. Rc 


ener ter | | over rer} 
[Ben | tie Vat Can ie var 


Notice that Bits marked L indicate that these 
can be read and written but are not effective. 


Reset Mixer(W): 
|index|_o7 | pe | os | 04 | os [ v2 | 01 | bo | 


RESET MIXER 
Writing any value to this register will reset the 
Sound Blaster Pro Mixer Register. 
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Voice Volume Control (R/W): 


[index] _p7_| pe _| 05 | pa | 3 | v2 | or | do | 


| o4h | Voice vol.tch | - [| Voicevol.Ren | - | 


Voice Vol. L/Rch 
Voice Volume Control : 
the gain level for the left/right channel of the 


These bits determine 


Voice in 8 steps. 


default : 99h 
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| 


MIC Volume Control (R/W): 
|index|_o7 | pe | os | 04 | 03 [ v2 | 0 | bo | 


MIDI Volume Control (R/W): 
|index|_o7 | pe | os | o4 | 03 [ v2 | 0 | bo | 


joan | - | - | - | - | - = - | 


MIC Vol. 
These bit can be read/written but are not 
effective, so MIC volume control is not 


supported. 


default : 11h 


Input Control (R/W): 
|index|_o7 | pe | os | 04 | 03 [ v2 | 0 | bo | 


| 26n | midivol.tch | - | Midivol. Ren | -_| 


MIDI Vol. L/Rch 
MIDI Volume Control : These bits determine 
the gain level for the left/right channel of the 
MIDI in 8 steps. 


default : 99h 


CD Volume Control (R/W): 
|index|_o7 | de | os | 04 | 03 [ v2 | 0 [ bo | 
| zsh | cdvoitch | - |  cdvo.Ren | - | 


Input Low 
0Ch Filter Pass | Input Source 
Filter 


Input Filter, Low Pass Filter, Input Source 


These bit can be read/written but are not 
effective, so the capture feature is not 


supported in Sound Blaster Pro. 


default : 11h 


Output Control (R/W): 
|index|_o7 | de | os | 04 | os [ v2 | 0 [ bo | 


Output Stereo 
OEh Filter SW 


Output Filter, Stereo SW 
When Stereo SW bit is set to “1”, output is 
Stereo mode, when this bit is set to”0”, output 


is Mono mode. 


default : 11h 


Master Volume Control (R/W): 
|index|_o7 | de | os | 4 | 03 [ v2 | 0 | bo | 


| 22h | Master Vol.tch | - | Master Vol.Rch | -_| 
Master Vol. L/Rch 
Master Volume Control : These bits determine 
the gain level for the left/right channel of the 


master in 8 steps. 


default : 11h 
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CD Vol. L/Rch 
CD Volume Control : These bits determine the 
gain level for the left/right channel of the CD 


in 8 steps. 


default : 11h 


LINE Volume Control (R/W): 
index | D7 _}| D6 | D5 | D4 | D3 _| D2 | D1 | Do 


| 2eh | LINEVol.tch | - [| LINEVol.Rch_ | - | 


LINE Vol. L/Rch 
LINE Volume Control : These bits determine 
the gain level for the left/right channel of the 
LINE in 8 steps. 


default : 11h 


The actual values written to the Master Vol., MIDI 
Vol., CD Vol. and Line Vol. are based on the Table 
2-2 shown below. When read, the actual value cannot 
be read --- the value written to each register is read 


instead. 
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Table 2-2 Master Volume vs. Each Volume 
Master vs. Voice, CD, and Line Volume Table 


EF eed Voice Vol. (04h), CD Vol. (28h), Line Vol. 
Fe a a = eee 


| 1 | mute | -28.506 | -22.508 | -16.548 | -10.508 | -7.5d8 | 3.008 | _OdB | 
| 2 | mute _| -22.508 | -16.508 | -10.58 | 7.508 | -3.008| 0dB| Od | 
| 3 | mute | -16.508 | -10.508 | -7.58 | -3.008 | 0dB| 0dB| Od | 


[0 | mute | mute | mute | mute | mute | mute | mute | mute | 
1 
2 
3 
4 


dB OdB 
| 4 | mute | -to508| -7.508| -3.008| 048 | 0d | _0dB 


| 6 


Master vs. MIDI Volume Table 


MIDI Vol. (26h 
Lee ee ee eee 7 
| mute | mute | mute | mute | mute | mute | mute _| 


ip 


| 1 | mute | 24.008 | -18.008 | -12.008 | -6.008 | -3.008 | +1.508 | +4.508 | 
| 2 | mute _| -18.008 | -12.008 | -6.008 | -3.008 | +1.508 | +4508 | +4.5¢8 | 
| 3 | mute _| -12.008 | -6.008 | -3.008 | +1.508 | +4508 | +4508 | +4.5¢8 | 


Lo | mute mute mute mute mute mute mute 
1 
2 
3 
4 
5 


4 | 

[5 | mute | 3.008 | +1508 | +4508 | +4508 | +4508 | +4508 | 44.508 | 
[6 | mute | +1508 | 14.508 | +4508 | +4508 | +4508 | +4508 | 44.508 | 
mute 


Sound Blaster Pro Mixer registers correspond to the 


CODEC Mixer registers as follows. The default state 


Sound Blaster Pro Mixer register vs. CODEC Mixer register 


Sound Blaster Pro CODEC Sound Blaster Pro | Mixer Default Value 
LINE Vol. LINE Vol. Master Vol. 


CD Vol. 


AUX1 Vol. MIDI Vol. +4.5 [dB] (99h 


MIDI Vol. AUX? Vol. 0 [dB] (99h 


LINE Vol. mute (11h 


CD Vol. mute (11h 
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2-4. DSP Command DOS application in regarad to audio data playback 
Listed below are the supported DSP commands mainly. 
defined by Sound Blaster Pro. Notice the supported 
commands are compatible with the standarad game on 
CMD Support Function 

10h fo) 8 bit direct mode digitized sound I/O output 

14h fe) 8 bit single-cycle DMA mode digitized sound output 

16h : 8 bit to 2 bit ADPCM single-cycle DMA mode digitized sound output 

17h ig 8 bit to 2 bit ADPCM single-cycle DMA mode digitized sound output with ref. byte 

1Ch fe) 8 bit auto-init DMA mode digitized sound output 

1Fh : 8 bit to 2 bit ADPCM auto-init DMA mode digitized sound output with ref. byte 

20h % 8 bit direct mode single byte digitized sound input 

24h x 8 bit single-cycle DMA mode digitized sound input 

2Ch 8 bit auto-init DMA mode digitized sound input 

30h o(* Polling mode MIDI input 

31h o(* Interrupt mode MIDI input 

34h o(* UART polling mode MIDI I/O 


36h o(* UART polling mode MIDI I/O with time stamping (MIDI data can not be received) 
37h o(* UART interrupt mode MIDI I/O with time stamping (MIDI data can not be received) 
38h o(* MIDI output 
40h fo) Set digitized sound transfer Time Constant 
48h fo) Set DSP block transfer size 
74h fo) 8 bit to 4 bit ADPCM single-cycle DMA mode digitized sound output 

fo) 


) 
) 
) 
35h o(*) UART interrupt mode MIDI I/O 
) 
) 
) 


75h 8 bit to 4 bit ADPCM single-cycle DMA mode digitized sound output with ref. byte 


76h 8 bit to 3 bit ADPCM single-cycle DAM mode digitized sound output 

77h : 8 bit to 3 bit ADPCM single-cycle DMA mode digitized sound output with ref. byte 

7Dh fe) 8 bit to 4 bit ADPCM auto-init DMA mode digitized sound output with ref. byte 

7Fh x 8 bit to 3 bit ADPCM auto-init DMA mode digitized sound output with ref. byte 

80h fe) Pause DAC for a duration 

90h fe) 8 bit high-speed auto-init DMA mode digitized sound output 

91h fo) 8 bit high-speed single-cycle DMA mode digitized sound output 

98h x 8 bit high-speed auto-init DMA mode digitized sound input 

99h : 8 bit high-speed single-cycle DMA mode digitized sound input 

AOh : Set input mode to mono 

A8h * Set input mode to stereo 

DOh fe) Pause 8 bit DMA mode digitized sound I/O 

D1h e Turn on speaker 

D3h - Turn off speaker 

D4h fe) Continue 8 bit DMA mode digitized sound I/O 

D8h - Get speaker status 

DAh fo) Exit 8 bit auto-init DMA mode digitized sound I/O 

Eth fo) Get DSP version number 
Note: 3) YMF715/715B are not supported the 
1) The commands marked “*” are performed in state- commands marked “(*)”. 


machine, but they are not effective. 
2) Additional undocumented commands are included. 
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3. CODEC Register Descriptions 
The following are the detail descriptions of 
YMF715x (OPL3-SA3) CODEC registers that are 
shown in YMF715x (OPL3-SA3) specifcation. 


3-1. General Description 

YMF715x (OPL3-SA3) CODEC is the integrated 
circuit for performing audio data playback/recording 
in PC enviroment. The functions include stereo 
Analog-to Digital and Digital-to Analog converters, 
analog mixer, 5 analog inputs (LINE, AUX#1(CD), 
AUX#2, MIC, Mono), simultaneous capture and 
playback at the same sampling frequency (supports 
the independent sampling frequency by software 
(device driver)) and programmable timer (resolution 
9.969/9.921 usec). 5 analog inputs can be mixed with 
output of DAC, synthesizer (FM/wavetable/ZV port) 
and Sound Blaster audio data with volume control. 3 
analog inputs (LINE, AUX#1(CD), MIC) can be 
multiplexed to the ADC. Some data modes are 
supported including 8/16 bit linear etc. 

YMF715x (OPL3-SA3) CODEC has analog mixer 
that includes attenuation controls for audio sources. 
Then individual audio source are summed into the 
mixer. Example, the AUX#Il (CD) mix register 
provides 32 volume control in 1.5dB steps and mute 
control YMEF715x (OPL3-SA3) CODEC is 
compliant with MPC Level-3. 

The following are the I/Os for YMF715x (OPL3- 
SA3) CODEC. 


CODEC base+0 | R | Configuration Register 
CODEC base+3| R_| StatusRegister 
CODEC base+4 Direct Register Index Address port 


CODEC base+5. Direct Register Index Data port 
CODEC base+6 Direct Register Status Register 
CODEC base+7 Direct Register PIO Data port 


Copyright (C) YAMAHA Corporation, 1997. All rights reserved. 
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| 


3-2. Configuration/Status Register 
This section describes about confiuration and status 


register. 


Configuration Register (RO): 
| port | _o7 [| o6 | os | p4 | v3 [| v2 | 01 | do | 
[son | o" | ov | irazo | waz 


This register is used to indicate which resources are 
assigned; it is a read only register. 
IRQ 2-0: 

“OQ” : No interrupt channel is available 

“1” : IRQ7 is available 

“2” : IRQ9 is available 

“3” : IRQ1O is available 

“4” > IRQ1I1 is available 


“5”-"7” + reserved. 


DMA 2-0: 
“0” : No DMA channel is available 
“1” : DMAO is available 
“2” : DMA is available 
“3” : DMA3 is available 


“4r—“7” + reserved 


Note) 

When the CODEC is in Dual DMA mode, only the 
playback DMA channels are valid and the recording 
DMA channels are ignored. 


Configuration Register (RO): 
| port | 07 | oe | os | v4 | os | v2 | 1 | oo | 


| +3n_[spHo| “oy | ‘or | or [or fi | or | 0 | 


SBHC 
If this bit is “0”, the board is in a 16-bit slot, 
and if this bit is “1”, the board is in an 8-bit 
slot and DMAO, IRQ10, and IRQI1 are not 
valid. 

D5-0 
Always returns 04h. 
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ip 


| 


Table 3-1 CODEC Direct Register Mapping 


CODEC Direct Registers (R/W): 


Index Data 


PIO Data 


Damp StCt~—“—~*S*™*~*~SODSCC“‘“COCSCN#C#*#*” 


Table 3-2 CODEC Indirect Register Mapping 
CODEC Indirect Registers (R/W): 


index [ D7 [| dé | 05 | D4 | Da] be | oY | DO | 
| ooh _ | tssi | LSso_ | LMGE | - | LiGs | Lica | Lici | LIGo_ | 
-oin_[-Assi_|_Asso_[ AMGE | - | RIGs | RiG2_| Rict | RIGO | 
oan ixim |= | - | oxtea | oxies | txiee | ixtar | ixteo | 
oan [Axi |_| axGa | AxiGs | Axte2 | AXIGT | AXIGO | 
oan | txem [= [| bxaaa | txaaa | Lxoce | Lxeat | 1x20 | 
05h | axXeM [|__| RxaGa | axoGs | Axaq2 | Rx2GT_| AX2GO | 
"06h [tom [~~ | LOAS_| toad | Loas | LOA? | LOAT | LOAO | 
—o7h [Rom _|_- | ROAS | ROA4 | _ROAS | ROAZ | ROAT | ROAO | 
"09h crio_| PPIO[- | - | AGAL | sbc | CEN | PEN | 
Pah Exe Jomor| = [= | ef es Ne 
sh [con | PUR | Acr_| ors | | o | 0 | o | 
ocr [wo [woos | - | - | wa | 2 | i | 10 | 
opr [teas | Leas | 1BAa_| 1BA2 | teat | LBAO | - | Lee | 
[jon [ois [Te [oMce | pmce | - | - | - | nacz | 
ie ee ae a [ES ST 
[enum | - [| - ues | ues [tee [ier | ico | 
[rah [Rim _|_- [| - | Alea | rica | ALG? | ALG? | ALGO | 
TUO 

a a Ry a | 
Fe ee eG a] 
en [| [ao |e | ow | co | po | Pu] 
ren [va [wif vo | - | - | 2 [cr | co _| 
ah [ wim [= | - | |i [_a[ iat | wa] 
Fe ee Ger are kee 
ion Furi | euro [ok | sm | - | - | - | -_| 
FET [eae rm (ea Se fe | a) 
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3-3. CODEC Direct Registers 
The Table 3-1 is shown the CODEC direct register 
all the direct 


mapping. This section describes 


registers. 


Index Address Register (R/W): 
| port | _o7 | de | os | v4 | 03 [ v2 | 0 | bo | 


INIT 
CODEC Initialization During CODEC 
initialization, this bit is read as “1”. CODEC 
initialization is caused by changing sampling 
frequency and clock format and resetting by 
RESET pin. This bit is read only. 


MCE 

Mode Change Enable : This bit should be set 
to “I” whenever the current mode of the 
YM715x (OPL3-SA3) CODEC is changed. 
The Data Format (indirect register, index 08, 
1Ch) and Interface Configuration (indirect 
register, index O9h) registers CANNOT be 
changed unless this bit is set to “1”. The 
exceptions are index 09h, CEN and PEN bits. 
The wave output is muted when MCE is set to 
“7, 


TRD 
Transfer Request Disable : 


Index Address 4-0 
These bits specify the address of the indirect 
register accessed by the Index Data Register 
(port+5h). Bit 4 allows access to indirect 
registers 10-1Fh. Bit 4 is only available 
MODE=!1 (indirect register, index OCh). These 


bits are read/write. 


default : 40h 
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Index Data Register (R/W): 
| port | _o7 | pe | os | v4 | 03 [| v2 | 0 | bo | 


Index Data 7-0 


These bits are the Data register referenced by 
the Index Address register (port+4h). 


default : OOh 


Status Register (RO): 
| port | _o7 [| o6 | os | os | v3 [ v2 | 1 | do | 


CU/L 
Capture Upper/Lower Byte ready : This bit 
indicates whether the capture data ready is for 
the upper or lower byte of the channel. If this 
bit is set to “1”, upper byte or any 8-bit ready. 


CL/R 
Capture Left/Right Sample : This bit indicates 
whether the capture data waiting is for the left 
channel or right channel. If this bit set to “1”, 


left channel or Mono data. 


CRDY 
Capture Data Ready : 


SER 
Sample Error : This bit indicates that sample 
was not serviced in time and an error has 
occurred. The bit indicates an overrun of 


capture and underrun for playback. 


PU/L 
Playback Upper/Lower Byte ready : This bit 
indicates whether the playback data needed is 
for the upper or lower byte of the channel. If 
this bit is set to “1”, upper byte or any 8-bit 


mode. 
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ip 


| 


PL/R 
Playback Left/Right Sample : This bit 
indicates whether the playback data needed is 
for the left channel or right channel. If this bit 


set to “1’’, left channel or Mono data. 


PRDY 
Playback Data Ready : 


INT 

Interrupt Status : This indicates the status of 
the internal interrupt logic of YMF715x 
(OPL3-SA3). This bit is cleared by any write 
of any value to this register. Indirect register, 
index OAh, IEN bit determines whether the 
state of this bit is reflected on the IRQn signal 
pin assigned to the CODEC. If this bit is read 


as “1”, interrupt active. 


default : CCh 


PIO Data Register (R/W): 
| port |_o7 [| o6 | os | ps | v3 [| v2 | 01 | do | 


+7h PIO Data 


PIO Data 

Playback/Capture Data port : This is the 
control register where playback/capture data is 
written/read during programmed I/O data 


transfers. 


default : 80h 


3-4. CODEC Indirect Registers 

The Table 3-2 is shown the CODEC indirect register 
mapping. This section describes all the indirect 
registers. Note that indirect registers, index 10-1Fh 
are only available when the indirect register, index 
OCh, MODE bit is set to “1”. 
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Left ADC Input Control (R/W): 
|index|_o7 | de | os | 4 | 03 [ v2 | 0 | bo | 


| oon [iss [{isso]imae] - | ties | tice | uct | Liao | 


LSS1-0 
Left ADC Input Source Select : These bits 
determine the analog input source for left 
channel recording. 
“0” : Left LINE - LINEL 
“1”: Left AUX - AUXIL 
“2”: Left MIC - MIC 
“3” : Left Line out Loopback 


LMGE 
Left MIC gain enable : This bit enables the 
20dB gain stage of the left mic input signal. 


LIG3-0 
Left ADC Gain : These bits determine the left 
channel gain level of the analog source 
recording volume in -1.5 dB steps. When all 
bits are set to “0”, volume is maximum (0 dB) 
and when all bits are set to “1”, volume is 
minimum (+22.5 dB). 


default : 0OOh 


Right ADC Input Control (R/W): 
[index] _p7 [| pe | 05 | o4 [| 03 | v2 | or | do | 


| on [Rssi[{Rsso|rmce] - [rics | Rica | rict | Rico | 


RSS1-0 
Right ADC Input Source Select : These bits 
determine the analog input source for right 
channel recording. 
“0” : Right LINE - LINER 
“1” : Right AUX1 - AUXIR 
“2”: Right MIC - MIC 
“3” : Right Line out Loopback 


RMGE 
Right MIC gain enable : This bit enables the 
20dB gain stage of the right mic input signal. 


Copyright (C) YAMAHA Corporation, 1997. All rights reserved. 


July 11, 1997 


YMEF71 5x(OPL3-SA3) Register Description Document YAMAHA 


RIG3-0 
Right ADC Gain : 


right channel gain level of the analog source 


These bits determine the 


recording volume in -1.5 dB steps. When all 
bits are set to “0”, volume is maximum (0 dB) 
and when all bits are set to “1”, volume is 
minimum (+22.5 dB). 


default : OOh 


Left Aux#1 Input Control (R/W): 
|index|_o7 | de | os | 04 | os [ 2 | 0 [ bo | 


| ozh [uxim] - | - |ixiesfixtes|ixia2|ixiar|ixieo| 


LX1M 
Left Aux#1 Mute : Setting this bit to “1” 
mutes the left channel of the AUX#1. 


LX1G4-0 
Left AUX#1 Gain : These bits determine the 
gain level for the left channel of the AUX#1 in 
-1.5 dB steps. When all bits are set to “0”, 
volume is maximum (+12 dB) and when all 
bits are set to “1”, volume is minimum (- 
34.5dB). 


default : 88h 


Right Aux#1 Input Control (R/W): 
|index|_b7_| pe | os | o4 | o3 [| v2 | 01 [ vo | 


| osh_[rxim] - | - |rxicalaxics|axiea|axiai[Axico| 


RX1IM 
Right Aux#1 Mute : Setting this bit to “1” 
mutes the right channel of the AUX#1. 


RX1G4-0 
Right AUX#1 Gain : These bits determine the 
gain level for the right channel of the AUX#1 
in -1.5 dB steps. When all bits are set to “0”, 
volume is maximum (+12 dB) and when all 
bits are set to “1”, volume is minimum (-34.5 
dB). 


default : 88h 
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Left Aux#2 Input Control (R/W): 
|index|_o7 | de | os | 4 | 03 [ v2 | 0 | bo | 


| oan [uxam] - | -  |ixeaa[ixees|ixace|ixaar|Lxeco| 


LX2M 
Left Aux#2 Mute : Setting this bit to “1” 
mutes the left channel of the AUX#2. 


LX2G4-0 
Left AUX#2 Gain : These bits determine the 
gain level for the left channel of the AUX#2 in 
-1.5 dB steps. When all bits are set to “0”, 
volume is maximum (+12 dB) and when all 
bits are set to “1”, volume is minimum (-34.5 
dB). 


default : 05h (+4.5[dB]) 


Right Aux#2 Input Control (R/W): 
|index|_b7_| pe | os | o4 | 03 [ v2 | 01 | vo | 


| osh_|rxem] - | -  |rxacalrxecs|axiea|axiai[rxico| 


RX1IM 
Right Aux#2 Mute : Setting this bit to “1” 
mutes the right channel of the AUX#2. 


RX1G4-0 
Right AUX#2 Gain : These bits determine the 
gain level for the right channel of the AUX#2 
in -1.5 dB steps. When all bits are set to “0”, 
volume is maximum (+12 dB) and when all 
bits are set to “1”, volume is minimum (-34.5 
dB). 


default : 05h (+4.5[dB]) 


Left Wave Output Control (R/W): 
[index | 07 | oe | os | v4 | os | v2 | m1 | co | 


| o6n | tom| - | L0as | L0a4[Loas | Loa2 | Loat | Load | 


LOM 
Left Wave Mute : Setting this bit to “1”? mutes 


the left channel of the wave output. 
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LOAS-0 
Left Wave output Gain : These bits determine 
the gain level for the left channel of the wave 
output in -1.5 dB steps. When all bits are set to 
“0”, volume is maximum (0 dB) and when all 
bits are set to “1”, volume is minimum (-94.5 
dB). 


default : 80h 


Right Wave Output Control (R/W): 
[index | _p7_[ 6 | os | v4 | v3 [ v2 | 01 | do | 


| o7h |ROm| - | ROAS| ROAS | ROAS| ROAZ| ROAt | ROAO| 


ROM 
Right Wave Mute : 


mutes the right channel of the wave output. 


Setting this bit to “1” 


ROAS-0 

Right Wave output Gain These _ bits 
determine the gain level for the right channel 
of the wave output in -1.5 dB steps. When all 
bits are set to “0”, volume is maximum (0 dB) 
and when all bits are set to “1”, volume is 


minimum (-94.5 dB). 


default : 80h 


Fs and Playback Data Format (R/W): 
|index|_o7 | de | os | 04 | os [ v2 | 0 | bo | 


FM1-0, C/L 

The FM1-0 and C/L bits set the audio data 
format as shown below. If index OCh, 
MODE=0, FM1 is forced low, FMO, and C/L 
bits are used for both playback and capture. If 
MODE=1, These bits are only used for 
playback format, and indirect register, index 
1Ch is only used for capture format. Direct 
register, port+4h, MCE bit or indirect register, 
index 10h, PMCE bit must be set to “1” to 
modify these bits. 
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0 1 0 Linear, 16-bit 2’s complement 
Little Endian 


1 1 0 Linear, 16-bit 2’s complement 
Big Endian 


S/M 

Stereo/Mono Select : This bit determines how 
the audio data streams are formatted. If 
MODE-0, this bit is used for both playback 
and capture. If MODE=1, this bit is only used 
for playback format, and indirect register, 
index 1Ch is only used for capture format. If 
this bit is set to “1”, audio data format is 
Stereo. Direct register, port+4h, MCE bit or 
indirect register, index 10h, PMCE bit must be 
set to “1” to modify this bit. 


CFS2-0, C2SL 

Clock Frequency Divide Select : CFS2-0 bits 
specify the audio sample frequency for both 
playback and capture. C2SL bit specifies the 
clock source used for the audio sample rates 
for both playback and capture. Direct register, 
port+4h, MCE bit must be set to “1” to modify 
these bits. 


CFS2-0 C2SL=0 C2SL=1 
3072 8.0kHz 5.51kHz 
1536 16.0kHz 11.025kHz 


Pasi [ont [07s 


default : OOh 
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Interface Configuration (R/W): 


[index] _p7 | p6_| 05 | p4 [ps | v2 | or | do | 


| ooh [opio[prio| - | - [acat] soc | cen | PEN | 


CPIO 
Capture PIO Enable 
whether the capture data is transferred via 
DMA or PIO. If this bit is set to “1”, PIO 


transfers. 


: This bit determines 


PPIO 
Playback PIO Enable : This bit determines 
whether the playback data is transferred via 
DMA or PIO. If this bit is set to “1”, PIO 


transfers. 


ACAL 
Digital Filter Initialize Enable : If this bit is set 
to “1”, index OBh, ACI bit is read as “1” 
during about 64fs whenever direct register, 
port+4h, MCE bit changes from “1” to “O” and 
internal digital filter is initialized. If this bit is 
set to “O”, ACI bit is read as “O” and internal 


digital filter is not initialized. 


SDC 
Single DMA _ Channel This bit forces 
YMF715x (OPL3-SA3) to use one DMA 
channel. If this bit is set to “1”, single DMA 
channel mode, and if this bit is set to “0”, dual 
DMA channel mode. 


CEN 
Capture Enabled : This bit enables the capture 
data. This bit may be set to “1’/’0” without 
setting the MCE bit. If this bit set to “1”, 


capture enabled. 


PEN 
Playback Enabled : This bit enables the 
playback data. This bit may be set to “1’7/’’0” 
without setting the MCE bit. If this bit set to 
“1”, playback enabled. 


default : O8h 
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Pin Control (R/W): 
|index|_o7 | de | os | 04 | 03 [ v2 | 0 | bo | 


jean [emit | emg se ee ent [es 


XTLI1-0 
These bits can be read/written but are not 


effective. 


IEN 
Interrupt Enable : This bit enables the 
YMF715x (OPL3-SA3) CODEC interrupt. 
The interrupt will reflect the direct register, 
port+6h, INT bit. 


default : 0OOh 


Error Status and Initialization (RO): 


[index] _p7 | pe _| 05 | p4 | 03 | v2 | or | do | 


| op | cor | pur | aci | ors | ‘o" | ‘or | “or | ‘o” | 


COR 
Capture overrun : This bit is read as “1” when 
the capture data has not been read by the host 
before the next sample arrives. This bit is read 
as” 1” when an error condition occurs and will 
not clear until the direct register, port+6h is 


read. 


PUR 
This bit is read as “1” 


when the playback data has not arrived from 


Playback Underrun : 


host in time to be played. This bit is read 
as’ 1” when an error condition occurs and will 
not clear until the direct register, port+6h is 


read. 


ACI 
Digital Filter Initialization in-progress : This 
bit indicates the state of digital filter 
initialization. If this bit is read as “1”, digital 


filter initialization is inprogress. 
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DRS 
DRQn status : 
status of the DRQn assigned to YMF715x 
(OPL3-SA3) CODEC. If this bit is read as “1”, 
capture or playback DRQn are presently 


This bit indicates the current 


active. 


default : 0OOh 


MODE and ID (R/W): 
Jindex | _b7_| 06 | 05 | o4 | 03 | v2 | o1 | bo | 


| och | mid [move] - | - [| 103 | we | wt | io | 


MID 
Manufactured ID : This bit is read as ”1” and 


read only. 


MODE 
Mode enable : 


access to indirect registers, index 10-1Fh and 


Setting this bit to “1” enables 
their associated features. 

ID3-0 
CODEC ID : These bits are read as “(1010)” 


and read only. 


default : 8Ah 


Loopback Control (R/W): 
|index | _p7_[ o6 | os | p4 | os [ v2 | 01 | do | 


| opn | ueas|Lpa4| Bas | iBa2{iBat| Bao] - | LBE | 


LBAS5-0 
Loopback Attenuation : These bits determine 
the gain level for the loopback in -1.5 dB steps. 
When all bits are set to “0”, volume is 
maximum (0 dB) and when all bits are set to 


“1”, volume is minimum (-94.5 dB). 
LBE 
Loopback Enable : Setting this bit to “1” 


enables that the ADC data is digitally mixed 
with data sent to the DACs. 


default : OOh 
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Playback Upper Base (R/W): 
|index|_o7 | de | os | 04 | 03 [ v2 | 0 [ bo | 


PUB7-0 

Playback Upper Base : This register is the 
upper byte which represents the 8 MSB of 16 
bit playback base register. Reading from this 
register return the same value which was 
written. The current count registers cannot be 
read. If index 0Ch, MODE=0 and index 09h, 
SDC=1, this register is used for both the 


playback and capture base registers. 


default : 0OOh 


Playback Lower Base (R/W): 
|index | _p7_[ p6 | os | v4 | v3 [ v2 | 01 | do | 


PLB7-0 
Playback Lower Base : This register is the 
lower byte which represents the 8 LSB of 16 
bit playback base register. Reading from this 
register return the same value which was 
written. The current count registers cannot be 
read. If index 0Ch, MODE=0 and index 09h, 
SDC=1, this register is used for both the 


playback and capture base registers. 


default : OOh 


Alternate Feature Enable 1 (R/W): 
|index|_o7 | pe | os | 4 | 03 [ v2 | 0 | bo | 


| ton | orp | te [omcelpmce] - | - | - |pacz| 


OLB 
Output Level Bit : 
level. 
“0” : Full scale 2.0Vp-p 
“1” : Full scale 2.8Vp-p 


This bit controls output 
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TE 
Timer Enable : Setting this bit to “1” enables 
the CODEC timer to run and report the 
interrupt to host at the specified frequency in 


the timer registers, index 14-15h. 


CMCE 

Capture Mode Change Enable : This bit 
should be set to “1” when the stereo/mono and 
audio data format bits for the capture channel, 
index 1Ch is changed. Direct register, port+4h, 
MCE bit should be used to change the sample 


frequency in index O8h. 


PMCE 
Playback Mode Change Enable : This bit 
should be set to “1”? when the stereo/mono and 
audio data format bits for the playback channel, 
index 08h is changed. Direct register, port+4h, 
MCE bit should be used to change the sample 


frequency in index O8h. 


DACZ 
DAC Zero : This bit will force the output of 
the playback channel to AC zero. 
“0” : Go to center scale 


“1” : Hold previous valid sample 


default : 0OOh 


Alternate Feature Enable 2 (R/W): 
|index|_o7 | de | os | 04 | 03 [ v2 | 0 | bo | 


[aitiellinee a| ace Mee ie 1] ee eel Ser) 


HPF 
This bit can be read/written but are not 


effective. 


default : 0OOh 
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Left Line Input Control (R/W): 
|index|_o7 | pe | os | 04 | os [ 2 | 0 [ bo | 


| i2n [um] - | - |ircs{iias | tree | iat | ico | 


LLM 
Left Line Mute : Setting this bit to “1” mutes 
the left channel of the Line. 

LLG4-0 


Left Line Gain : These bits determine the gain 
level for the left channel of the Line in -1.5 dB 
steps. When all bits are set to “0”, volume is 
maximum (+12 dB) and when all bits are set to 


“1”, volume is minimum (-34.5dB). 


default : 88h 


Right Line Input Control (R/W): 
[index] _p7 [| pe | os | o4 | 03 | v2 | or | do | 


| isn [rum] - | - |rvcs{ ates] Ata | iat | Rico | 


RLM 
Right Line Mute : Setting this bit to “1” mutes 
the right channel of the Line. 


RLG4-0 
Right Line Gain : 
gain level for the right channel of the Line in - 
1.5 dB steps. When all bits are set to “0”, 


volume is maximum (+12 dB) and when all 


These bits determine the 


bits are set to “1”, volume is minimum (-34.5 
dB). 


default : 88h 


Timer Lower/Upper Byte (R/W): 
|index|_b7_| pe | os | o4 | 03 [ v2 | 01 | vo | 


[index] _b7 | p6_| 05 | p4 [ps | o2 | or | do | 


TL7-0 
Lower Timer Bits : This is the low order byte 
of the 16-bit timer. 
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TU7-0 CO 
Upper Timer Bits : This is the high order byte Capture Overrun : This bit indicates that the 
of the 16-bit timer. The time base is ADC had a sample to load into the FIFO but 
determined by the clock source selected. the FIFO was full. In this case this bit is read 
C2SL=0 : 24.5760MHz/245 - 9.969 us as “1” and the new sample is discarded. 
C2SL=1 : 33.8688MHz/336 - 9.921 us 
PO 
default : OOh (index 14-15h) Playback Overrun : This bit indicates that the 
host attempted to write data into a full FIFO 
Notice) and the data was discarded. 
Index 16-17h registers are reserved. Don’t access 
these registers. PU 


Alternate Feature Status (RO): 
[index | _p7_[ o6 | os | p4 | os [ v2 | 01 | do | 


jishn]| - | m | co | [cu] co] po | pu | 


TI 

Timer Interrupt : This bit indicates that an 
interrupt is pending from the timer count 
registers. This bit is reset by writing “O” to it 
or by writing any value to the status register, 


port+6h. 


CI 
Capture Interrupt : This bit indicates that an 
interrupt is pending from the record DMA 
count registers. This bit is reset by writing “0” 
to it or by writing any value to the status 


register, port+6h. 


PI 
Playback Interrupt : This bit indicates that an 
interrupt is pending from the playback DMA 
count registers. This bit is reset by writing “0” 
to it or by writing any value to the status 


register, port+6h. 


CU 
Capture Underrun : This bit indicates that the 
host has read more data out of the FIFO than it 
contained. In this condition, this bit is read as 
“1” and the last valid byte is read by the host. 
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Playback Underrun : This bit indicates that the 
DAC has run out of data and a sample has 


been missed. 


default : 0OOh 


Version/ID (RO): 
|index|_o7 | de | os | 04 | os [ v2 | 0 | bo | 


| ton | ve | vi | vo | - [ - Joie | cips | cipo | 


V2-0 
Version Number : These bits indicate version 
of YMF715x (OPL3-SA3) CODEC and are 
read as “(100),”. 


CID2-0 
CODEC Identification : These bits indicate 
identification of YMF715x (OPL3-SA3) 
CODEC and are read as “(000),” 


default : 80h 


Mono Input Control (R/W): 
[index | _p7_[ o6 | os | p4 | v3 [| v2 | 01 | do | 


| ian | wm | - | - | - [mas | maa | wnat | mao | 


MIM 
Mono Input Mute : Setting this bit to “1” 


mutes the Mono input. 
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MIA3-0 
Mono Input Gain :These bits determine the 
gain level for the mono input -3.0 dB steps. 
When all bits are set to “0”, volume is 
maximum (0 dB) and when all bits are set to 


“1”, volume is minimum (-30.0 dB). 
default : COh 
Notice) 


Index 1Bh register is reserved. Don’t access this 


register. 


Capture Data Format (R/W): 
|index | _p7_[ 6 | os | p4 | v3 [ v2 | 01 | do | 


| ich | rw [emo] oo] sm{ - | - | - | - | 


FM1-0, C/L 
The FM1-0 and C/L bits set the audio data 
format as shown below. These bits are only 
used for capture format in MODE=1. Indirect 
register. Direct register, port+4h, MCE bit or 
indirect register, index 10h, CMCE bit must be 
set to “1” to modify these bits. 


0 1 0 Linear, 16-bit 2’s complement 
Little Endian 


| o | 1 | 1 | Ataw, 8-bitcompanded | 


1 1 0 Linear, 16-bit 2’s complement 
Big Endian 


S/M 

Stereo/Mono Select : This bit determines how 
the audio data streams are formatted. This bit 
is only used for capture format in MODE=1. If 
this bit is set to “1”, audio data format is 
Stereo. Direct register, port+4h, MCE bit or 
indirect register, index 10h, CMCE bit must be 
set to “1” to modify this bit. 


default : OOh 
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Notice) 
Index 1Dh register is reserved. Don’t access this 


register. 


Capture Upper Base (R/W): 
[index | 07 | oe | os | v4 | os | v2 | m1 | co | 


CUB7-0 

Capture Upper Base : This register is the 
upper byte which represents the 8 MSB of 16 
bit capture base register. Reading from this 
register return the same value which was 


written. 


default : 0OOh 


Capture Lower Base (R/W): 
[index | 07 | de | 05 | o4 | os | v2 | m1 | co | 


CLB7-0 

Capture Lower Base : This register is the 
lower byte which represents the 8 LSB of 16 
bit capture base register. Reading from this 
register return the same value which was 


written. 


default : 0OOh 
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ip 


| 


3-5. Digital Filter Initialization 

The following are shown YMF715x (OPL3-SA3) 
CODEC digital filter initialization sequence. 

When the register values concerned with Fs or XTAL 
(indirect register, index 08, 1Ch) are only changed, 
direct register, portt+4h, INIT bit is set to “1” during 
about 2-3fs if indirect register, index 09h, ACAL bit 
is set to “1”. If ACAL bit is set to “1”, index OBh, 


ACI bit is read as “1” during about 64fs whenever 
direct register, port+4h, MCE bit changes from “1” to 
“0”. ACI bit read as “1” means that digital filter 
initialization is inprogress. So notice that YMF715x 
(OPL3-SA3) CODEC needs the wait during this time. 
If ACAL bit is set to “0”, YMF715x (OPL3-SA3) 
CODEC digital filter is not initialized. 


MCE | | 


CSF2-0(n) != CSF2-0(n-1) etc. 


Fs/XTAL \: ' 


Fig.3-1 YMF715x(OPL3-SA3) CODEC Digital Filter Initialization Chart 
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4. MPU401 Descriptions 

MPU401 is the standard interface for controlling 
MIDI devices, e.g., wavetable synthesizer YMF721 
(OPL4-ML2) etc. from a PC. The YMF715x (OPL3- 
SA3) has an MPU401 MIDI interface with a 16-byte 
receive/transmit FIFO. The MIDI output data of the 
transmit FIFO will be serialized out the TXD pin of 
the YMF715x (OPL3-SA3). MIDI input data can be 
received from the RXD pin of the YMF715x (OPL3- 
SA3). The following are the I/Os for MPU401 
compatibility. 


MPU base+0 MIDI Data receive/transmit port 
MPU base+1 | R | Status Register port 


MPU base+1 Command Register port 


4-1. Register Descriptions 
This section describes all the MPU401 compatible 


registers. 


MIDI Data Transmit/Receive Port (R/W): 
| port | _o7 | de | os | v4 | os [ v2 | 0 | bo | 


MIDI Data 
MIDI Data Write/Read port : This is the port 
for transmit/receive of MIDI data. During both 
transmit and receive, it is necessary to watch 
the status register DSR and DRR bits. The 
YMF715x (OPL3-SA3) has an internal 16- 
byte FIFO for transmit/receive of MIDI data. 


Status Register Port (R): 
| port | _o7 [| dé | os | v4 | os [ v2 | 01 | do | 


|+in |osR|orR| - | - | - | - | - | - | 


DSR 

Receive Status : When MIDI data is ready, 
and when a command has been written, this 
will be “0”. When this bit is “0”, MIDI data 


must not be read. 
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DRR 
Transmit Status : When MIDI data can be 
written, this will be “0”. When this bit is “1”, 
MIDI data may not be written. 


default : (10xx xxxx), 


Command Register Port (W): 
| port | _p7 [| v6 | os | v4 | v3 [ v2 | 01 | do | 


COMMAND Data 
Command Data Write : Writing command data 
to this register will set the DSR bit to “0”, and 
FEh will be returned to the MIDI data register 
as an acknowledgment. YMF715x (OPL3- 
SA3) supports the following commands. 
“FFh” : MPU Reset (return the interface to 
non-UART mode 
“3Fh” : Set the interface to UART mode 


Note) UART Mode 

The UART mode is used to convert parallel data to 
the serial data required by MIDI. The serial data rate 
is fixed at 31.25k bps (+/- 1%). The serial data format 
is that | start bit, 8 data bits (LSB fast) and 1 stop bit. 
After power-on reset, MPU 401 interface is “non- 
UART mode”. When writing “3Fh” to the command 
register port, set the interface into “UART mode” and 
generate an interrupt and status register port, port+ lh, 
DSR bit can be read as “0”. When the MIDI data port 
is read “FEh” as an acknowledge, the interrupt is 
reset and DSR bit can be read as “1”. When writing 
“FFh” to the command register port, set the interface 
into “non-UART mode (MPU Reset)”. 
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5. Game Port 

Joystick port(Game port) consists of one I/O location, 
and has the following one read register. Currently the 
Joystick port is located at 201h in most games 
software (please refer to YMF715x (OPL3-SA3) 
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A write to this register, Joystick port(Game port), 
triggers quad timers. A read from this register returns 
quad status bits corresponding to the joystick fire 
buttons and four bits that correspond to the output 


from the quad timers. Each timer output remains low 


specification, “recommended resource data” section). for a period of time determined by the current 


joystick portion. 


| pot_|_p7 | p6 | os | p4 [| os | v2 | v1 | do | 


JBB2 

Joystick B, Button 2 
JBB1 

Joystick B, Button 1 
JAB2 

Joystick A, Button 2 
JAB1 

Joystick A, Button | 
JBCY 

Joystick B, Coordinate Y 
JBCX 

Joystick B, Coordinate X 
JACY 

Joystick A, Coordinate Y 
JACX 

Joystick A, Coordinate X 
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